home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / lib / X11 / xmmix.hlp < prev    next >
Text File  |  1995-07-05  |  5KB  |  135 lines
  1. #
  2. # @(#)xmmix.hlp    2.5 95/05/12
  3. #
  4. #   xmmix - Motif(tm) Audio Mixer
  5. #
  6. #   Copyright (C) 1995  Ti Kan
  7. #   E-mail: ti@amb.org
  8. #
  9. #   This program is free software; you can redistribute it and/or modify
  10. #   it under the terms of the GNU General Public License as published by
  11. #   the Free Software Foundation; either version 2 of the License, or
  12. #   (at your option) any later version.
  13. #
  14. #   This program is distributed in the hope that it will be useful,
  15. #   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. #   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17. #   GNU General Public License for more details.
  18. #
  19. #   You should have received a copy of the GNU General Public License
  20. #   along with this program; if not, write to the Free Software
  21. #   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22. #
  23.  
  24.  
  25.    NAME
  26.         xmmix - Audio mixer utility for X11/Motif
  27.  
  28.  
  29.    SYNOPSIS
  30.         xmmix [toolkitoption ...] [-dev device] [-autoload path]
  31.         [-exitreset] [-debug] [-demo]
  32.  
  33.  
  34.    DESCRIPTION
  35.         Xmmix is a program that allows the use of the mixer section
  36.         of the sound card hardware supported by the VoxWare driver.
  37.         See the README file in the xmmix distribution for further
  38.         information about VoxWare.
  39.  
  40.         There are up to ten input level sliders (Synth, PCM, Alt
  41.         PCM, Line, Line-1, Line-2, Line-3, Mic, CD) and up to four
  42.         output level sliders (Rec Mon, Rec Out, Speaker and Master).
  43.         The Input Gain control, Output Gain control, Bass and Treble
  44.         tone control sliders are also available.  Each of the level
  45.         sliders include a "lock" toggle button which allows the
  46.         settings of the two stereo channels to be changed
  47.         simultaneously or independently.  The input controls also
  48.         include a "rec" button (where applicable), which allows the
  49.         input sources to be selected for recording.  The tone
  50.         control sliders have a "Flat" button which causes these
  51.         controls to revert to the center setting.  In addition,
  52.         these controls are available: a "Mute" button to silence the
  53.         audio, a "Loudness" button to engage frequency response
  54.         compensation, and an "Stereo Enhance" button to set the
  55.         stereo separation enhancement.
  56.  
  57.         Xmmix queries the capabilities of the sound board during
  58.         start-up, and will only display controls corresponding to
  59.         features that are actually implemented in the hardware.
  60.  
  61.         The various controls in the xmmix main window are meant to
  62.         be self explanatory.  Additional features include the
  63.         ability to save mixer settings in a file and load it at a
  64.         later time.  A "Reset" feature resets all controls to their
  65.         start-up settings.
  66.  
  67.         While the use of a mouse is natural with xmmix, all
  68.         functionality can also be operated via the keyboard.  This
  69.         is in conformance to the guidelines published in the
  70.         OSF/Motif Style Guide from the Open Software Foundation.
  71.  
  72.  
  73.    OPTIONS
  74.         All standard Xt Intrinsics toolkit options are supported.
  75.         In addition, xmmix supports the following options:
  76.  
  77.         -dev device
  78.              Specifies the path name to the raw mixer device.  If
  79.              this option is not used, the default device used is
  80.              /dev/mixer.
  81.  
  82.         -autoload path
  83.              Specifies the path name to a mixer settings file that
  84.              is automatically loaded when xmmix starts.  This forces
  85.              all control settings to those specified in the file.
  86.              If this option is not used, then the control settings
  87.              will be queried from the mixer hardware itself.  This
  88.              option overrides the XMmix*autoLoadOnStartUp X
  89.              resource.
  90.  
  91.         -exitreset
  92.              Causes all mixer controls to reset to their start-up
  93.              state when xmmix is exiting.  This option overrides the
  94.              XMmix*resetOnExit X resource.
  95.  
  96.         -debug
  97.              Causes verbose debugging diagnostics to be printed on
  98.              stderr.
  99.  
  100.         -demo
  101.              Invokes xmmix in "demo" mode.  This causes xmmix to
  102.              display all controls as if they are functional, but
  103.              does not actually operate the sound hardware.
  104.  
  105.  
  106.    X RESOURCES
  107.         Xmmix has many adjustable X resources to customize its look
  108.         and feel, as well as its behavior.  Notably, the colors of
  109.         virtually every feature on xmmix's windows can be changed,
  110.         as well as the text fonts.
  111.  
  112.         The resource names and their defaults can be found in the
  113.         LIBDIR/app-defaults/XMmix file (where LIBDIR is typically
  114.         /usr/lib/X11).  It is not recommended that you change values
  115.         in the LIBDIR/app-defaults/XMmix file, unless you want the
  116.         changes to be forced upon all users of xmmix on the system.
  117.         Instead, make a copy of this file, change the copy as you
  118.         see fit, then place it in your home directory.  Your custom
  119.         resource settings will then override the defaults when xmmix
  120.         is subsequently started.  Alternatively, you may also place
  121.         specific resources you wish to override in the .Xdefaults
  122.         file in your home directory.
  123.  
  124.  
  125.    SEE ALSO
  126.         X(1).
  127.  
  128.  
  129.    AUTHOR
  130.         Ti Kan (ti@amb.org)
  131.         AMB Research Laboratories, Sunnyvale, CA, U.S.A.
  132.  
  133.         Comments, suggestions, and bug reports are always welcome.
  134.  
  135.